home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ircombine.z / ircombine
Text File  |  1998-10-30  |  34KB  |  595 lines
  1.  
  2.  
  3.  
  4. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ircombine - Create, modify, query, load and save video format
  10.      combinations
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ////uuuussssrrrr////ggggffffxxxx////iiiirrrrccccoooommmmbbbbiiiinnnneeee [destination] [source] [options]
  14.  
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      iiiirrrrccccoooommmmbbbbiiiinnnneeee creates and operates on _v_i_d_e_o _f_o_r_m_a_t _c_o_m_b_i_n_a_t_i_o_n_s, descriptions
  18.      of raster sizes and timings to be used on video outputs, as well as the
  19.      configuration of the underlying frame buffer.  The resulting combination
  20.      can be used as the current video configuration, stored as the default
  21.      configuration to be used at system power-up or graphics initialization,
  22.      or saved in a video format combination file.  The combination can be
  23.      created from scratch or by modifying the current or a saved combination.
  24.      iiiirrrrccccoooommmmbbbbiiiinnnneeee subsumes the functionality of sssseeeettttmmmmoooonnnn((((1111GGGG))))....
  25.  
  26.  
  27.    OOOOppppttttiiiioooonnnnssss
  28.      ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn [aaaaccccttttiiiivvvveeee | eeeeeeeepppprrrroooommmm | ffffiiiilllleeee <_f_i_l_e_n_a_m_e>] - This option specifies
  29.      the destination of the video format combination.  If this option is
  30.      omitted, and no queries are specified, iiiirrrrccccoooommmmbbbbiiiinnnneeee will bring up a
  31.      graphical interface by default.
  32.  
  33.  
  34.           aaaaccccttttiiiivvvveeee specifies that the combination will be loaded as the current,
  35.           active video configuration, but not saved in the eeprom.  This will
  36.           temporarily change the video configuration, but the combination will
  37.           not be used when graphics is initialized or the the system is
  38.           powered up. A destination of active is only legal if the target
  39.           machine is local.
  40.  
  41.           eeeeeeeepppprrrroooommmm specifies that the combination will be saved in the eeprom
  42.           and used as the default.  The combination does not take effect
  43.           immediately; it is only used the next time graphics is initialized
  44.           or the system is powered up.  To initialize graphics, use
  45.           (/_u_s_r/_g_f_x/_s_t_o_p_g_f_x; /_u_s_r/_g_f_x/_s_t_a_r_t_g_f_x) &
  46.  
  47.           ffffiiiilllleeee specifies that the combination will be saved in a video format
  48.           combination file <_f_i_l_e_n_a_m_e>.  <_f_i_l_e_n_a_m_e> is specified relative to
  49.           the current working directory.
  50.  
  51.  
  52.      ----ssssoooouuuurrrrcccceeee [aaaaccccttttiiiivvvveeee | ffffiiiilllleeee <_f_i_l_e_n_a_m_e>] - This option controls the source of
  53.      the combination to me modified, loaded, or queried.  aaaaccccttttiiiivvvveeee and ffffiiiilllleeee are
  54.      similar to the options to ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn.  If the source is aaaaccccttttiiiivvvveeee, the
  55.      destination must be aaaaccccttttiiiivvvveeee as well, and only the following parameters may
  56.      be modified: cursorpriority, filtersize, gain, gamma, hphase, pedestal,
  57.      schphase, sourceloc, sourcesize, vphase; in addition, if the source is
  58.      aaaaccccttttiiiivvvveeee channels may be disabled, but not enabled.  If -source is not
  59.      specified, all parameters which are not specified take on their default
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  71.  
  72.  
  73.  
  74.      values.
  75.  
  76.  
  77.      ----gggguuuuiiii - Brings up a graphical interface with which to create video format
  78.      combinations.  If this option is specified in conjunction with other
  79.      options which modify the combination, the other operations are performed
  80.      first, and the gui may be used to make additional modifications.  This
  81.      option may not be specified with ----ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn.  If no destination is
  82.      specified, and no queries are made to the combination, the graphical
  83.      interface is used by default.
  84.  
  85.      The following options modify the specified video format combination, or
  86.      query parameters of the combination and return them on stdout.
  87.  
  88.      ----gggglllloooobbbbaaaallll [[[[ppppaaaarrrraaaammmmeeeetttteeeerrrr||||ppppaaaarrrraaaammmmeeeetttteeeerrrr====vvvvaaaalllluuuueeee,,,,............]]]]  - Modifies or queries the global
  89.      attributes of the video format combination.  This option is followed by a
  90.      list of parameters or parameter assignments.  If no assignment is made,
  91.      the current setting of the parameter in the modified combination is
  92.      queried and returned on stdout.  Parameters may be specified multiple
  93.      times in order to both set and query a parameter.  Since commas delimit
  94.      parameters in this list, they not used in _v_a_l_u_e.  The following
  95.      parameters may be specified:
  96.  
  97.  
  98.           ggggaaaammmmmmmmaaaa====<_v_a_l_u_e> - Specifies the global output video gamma value for
  99.           this combination.  If the gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa parameter is OOOONNNN, this gamma
  100.           value is used for all channels in the combination.  Valid values for
  101.           gamma are floating point numbers in the range [0,20], and the
  102.           default is 1.7.  Setting this parameter modifies the gamma values on
  103.           all components of the output.  To modify the gamma value of a single
  104.           component, use one of the options ggggaaaammmmmmmmaaaarrrr, ggggaaaammmmmmmmaaaagggg, or ggggaaaammmmmmmmaaaabbbb.
  105.  
  106.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether the global gamma value is
  107.           used as the output video gamma for all channels in the combination.
  108.           The DG4-2 display generator supports a single output gamma map, so
  109.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa must be used with this target hardware.  The DG4-8
  110.           supports sixteen gamma maps, so each channel may use its own unique
  111.           gamma value.
  112.  
  113.           ppppiiiixxxxeeeellllddddeeeepppptttthhhh==== [ DDDDEEEEEEEEPPPPEEEESSSSTTTT | XXXXSSSS | SSSS | MMMM | LLLL | XXXXLLLL ] - Specifies the size
  114.           of the pixels to be used in the combination.  If XXXXSSSS, SSSS, MMMM, LLLL, or XXXXLLLL
  115.           is specified, the combination will only be used with this size
  116.           pixel, and will be invalid if the specified pixel size is not
  117.           available.  If DDDDEEEEEEEEPPPPEEEESSSSTTTT is specified, the largest pixel size which
  118.           can be supported by the hardware configuration will be chosen at the
  119.           time the combination is loaded.  When the combination is validated,
  120.           iiiirrrrccccoooommmmbbbbiiiinnnneeee will report the pixel size which would be chosen for the
  121.           given hardware configuration.
  122.  
  123.           ssssiiiizzzzeeee====_Xxxxx_Y - Specifies the size of the frame buffer in pixels.  The
  124.           y-size must be a multiple of 2.  The default is either 1280x1024 or
  125.           the minimum legal bounding rectangle of the specified combination,
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  137.  
  138.  
  139.  
  140.           whichever is larger.
  141.  
  142.           ssssyyyynnnnccccffffoooorrrrmmmmaaaatttt====<_n_a_m_e> - For external sync, specifies the name of the
  143.           video format file which describes the format to which the video
  144.           subsystem will lock.  If you do not specify an input genlock format,
  145.           the video format of the combination's lowest numbered channel with a
  146.           valid sync signal will be used.
  147.  
  148.           ssssyyyynnnnccccssssoooouuuurrrrcccceeee==== [IIIINNNNTTTTEEEERRRRNNNNAAAALLLL|EEEEXXXXTTTTEEEERRRRNNNNAAAALLLL] - Specifies whether the default
  149.           genlock source will be internal or external.
  150.  
  151.           tttteeeexxxxttttppppoooorrrrtttt====<_c_h_a_n_n_e_l _n_u_m_b_e_r> - Specifies the channel to be used as the
  152.           textport output.  This is the channel on which the PROM monitor is
  153.           displayed.  See pppprrrroooommmm((((1111MMMM)))).  This channel must be a valid channel in
  154.           the combination.  By default, the combination's lowest numbered
  155.           channel is used.
  156.  
  157.  
  158.      ----cccchhhhaaaannnnnnnneeeellll <_c_h_a_n_n_e_l> [_p_a_r_a_m_e_t_e_r|_p_a_r_a_m_e_t_e_r=_v_a_l_u_e,...]  - Modifies or queries
  159.      the attributes associated with the specified channel of the video format
  160.      combination.  <_c_h_a_n_n_e_l> may be a number in the range 0-7 to specify the
  161.      corresponding video channel, eeeennnnccccooooddddeeeerrrr to specify the encoder channel,
  162.      ssssiiiirrrriiiiuuuussss to specify the Sirius option board (if it exists), ddddpppplllleeeexxxx to
  163.      specify the dplex board (if it exists), ddddvvvvpppp to specify the digital video
  164.      port board (if it exists), or ggggvvvvoooo to specify the 601 serial digital video
  165.      out board (if it exists). The -channel option may be used multiple times
  166.      on a single command line to specify different channels of the video
  167.      format combination.  The assignment of parameters is similar in operation
  168.      to -b.  The following parameters may be specified:
  169.  
  170.  
  171.  
  172.           aaaallllpppphhhhaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies that this channel should produce the
  173.           alpha component of the pixels rather than RGB values.  This must be
  174.           used in conjunction with the RGBA10 pixel format, and produces the
  175.           alpha component on the blue component of the output.  When you use
  176.           this option, gamma correction is disabled for the channel.
  177.  
  178.           ccccuuuurrrrssssoooorrrrpppprrrriiiioooorrrriiiittttyyyy====_v_a_l_u_e - Specifies the priority of this channel for
  179.           cursor drawing.  This priority is used to determine which channel
  180.           displays the cursor in a region in which the input rectangles of two
  181.           or more channels overlap.  Numbers range from 0 to 255, with lower
  182.           numbers indicating higher priority.  If the cursor enters a region
  183.           shared by two channels of equal cursor priority, the channel which
  184.           last displayed the cursor retains it.  If the cursor did not
  185.           previously appear in either of the contending channels, the channel
  186.           with the lower channel number displays the cursor.
  187.  
  188.           ddddeeeelllleeeetttteeee - Specifies that the channel should be deleted from the
  189.           combination.  This parameter does not need to be given an
  190.           assignment.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  203.  
  204.  
  205.  
  206.           ddddiiiitttthhhheeeerrrr==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether or not the output of this
  207.           channel is to be dithered.  If ddddiiiitttthhhheeeerrrr is not selected, and the frame
  208.           buffer color representation has more precision than the the video
  209.           format, i.e., 12-bit RGB pixels in the frame buffer with RGB10 pixel
  210.           format for video, the colors will be truncated.  If dither is
  211.           selected, a fixed pattern of noise will be added to the colors
  212.           before they are truncated to reduce the perceptible artifacts
  213.           introduced by truncation.  By default, dithering is OOOOFFFFFFFF.
  214.  
  215.           eeeennnnaaaabbbblllleeee==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether this channel should be enabled
  216.           in the combination.  If a channel is disabled, but not deleted, the
  217.           definition of the channel is stored in the combination, but no
  218.           output is generated, and no bandwidth is consumed for the channel.
  219.           If any parameters are specified for a channel, it is enabled by
  220.           default; all other channels are disabled by default.
  221.  
  222.           ffffiiiilllltttteeeerrrrssssiiiizzzzeeee====_Xxxxx_Y - Specifies the size of the filters used when the
  223.           channel resizes the source pixels to the channel.  Values for the
  224.           x-filter are in the range [1,13], for the y-filter [1,7].
  225.  
  226.           ffffoooorrrrmmmmaaaatttt====<_f_o_r_m_a_t _n_a_m_e> - Specifies the name of the video format to be
  227.           used on this channel.  For the encoder channel, the only valid
  228.           values are NNNNTTTTSSSSCCCC and PPPPAAAALLLL, corresponding to the 640x486_30i and
  229.           768x576_25i formats.  For Sirius, the valid values are 555522225555, 666622225555,
  230.           CCCCCCCCIIIIRRRR666600001111____555522225555, and CCCCCCCCIIIIRRRR666600001111____666622225555, corresponding to the 646x486_30i,
  231.           768x576_25i, CCIR601_525 (720x485_25i), and CCIR601_625
  232.           (720x576_25i) formats, respectively.  For GVO, the valid values are
  233.           CCCCCCCCIIIIRRRR666600001111____555522225555____DDDDGGGGOOOO, and CCCCCCCCIIIIRRRR666600001111____666622225555____DDDDGGGGOOOO.  The default format for the
  234.           encoder is NNNNTTTTSSSSCCCC.  The default for Sirius is 555522225555.  The default for
  235.           GVO is CCCCCCCCIIIIRRRR666600001111____555522225555____DDDDGGGGOOOO.  The default format for all other channels
  236.           is 1280x1024_60.
  237.  
  238.           ggggaaaaiiiinnnn====<_v_a_l_u_e> - Specifies the default output video gain for this
  239.           channel.  The valid range is [0,10], and the default is 1.  This
  240.           value will be coerced to the closest gain which is physically
  241.           realizable on the output channel.  Thus, if the gain is set and
  242.           subsequently queried, the input and returned values may not be the
  243.           same.
  244.  
  245.           ggggaaaammmmmmmmaaaa====<_v_a_l_u_e> - Specifies the output video gamma value for this
  246.           channel.  Valid values for gamma are floating point numbers in the
  247.           range [0,20], and the default is 1.7.  Setting this parameter
  248.           modifies the gamma values on all components of the output channel.
  249.           To modify gamma value on a single component, use one of the options
  250.           ggggaaaammmmmmmmaaaarrrr, ggggaaaammmmmmmmaaaagggg, or ggggaaaammmmmmmmaaaabbbb.
  251.  
  252.           hhhhpppphhhhaaaasssseeee====<_v_a_l_u_e> - Specifies the default horizontal phase value for
  253.           this channel.  This setting applies only if the channel is genlocked
  254.           to external sync.  Positive values delay the genlocked video channel
  255.           with respect to external sync, and negative values advance it.
  256.           <_v_a_l_u_e> is a floating point number.  The default is 0000.
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  269.  
  270.  
  271.  
  272.           mmmmaaaaxxxxssssiiiizzzzeeee====_Wxxxx_H - Specifies the maximum size of the input region of the
  273.           frame buffer.  This places a limit on the bandwidth requirements of
  274.           the channel, and is used in validating the video format combination.
  275.           See also the ssssoooouuuurrrrcccceeeessssiiiizzzzeeee and mmmmiiiinnnnssssiiiizzzzeeee parameters.
  276.  
  277.           mmmmiiiinnnnssssiiiizzzzeeee====_Wxxxx_H - Specifies the minimum size of the input region of the
  278.           frame buffer.  If mmmmiiiinnnnssssiiiizzzzeeee is set equal to mmmmaaaaxxxxssssiiiizzzzeeee, the source
  279.           rectangle cannot be rescaled.  See also the ssssoooouuuurrrrcccceeeessssiiiizzzzeeee and mmmmaaaaxxxxssssiiiizzzzeeee
  280.           parameters.
  281.  
  282.           ppppaaaannnnsssstttteeeepppp====[ LLLLOOOOCCCCKKKKEEEEDDDD | PPPPIIIIXXXXEEEELLLL | TTTTIIIILLLLEEEE ]xxxx[ LLLLOOOOCCCCKKKKEEEEDDDD | PPPPIIIIXXXXEEEELLLL ] - Specifies the
  283.           resolution with which the input window of the channel may be panned
  284.           in x and y while the combination is active.  This parameter does not
  285.           affect the initial placement of the channel's source region.  LLLLOOOOCCCCKKKKEEEEDDDD
  286.           indicates that the source rectangle cannot be be moved in the
  287.           corresponding direction.  PPPPIIIIXXXXEEEELLLL indicates that the window can be
  288.           panned to any pixel location.  TTTTIIIILLLLEEEE for the x resolution indicates
  289.           that the x-coordinate of the window can only be moved in 160 pixel
  290.           increments, corresponding to one frame buffer tile.  This is used to
  291.           decrease the bandwidth requirement of a video format combination.
  292.           Because pixels are fetched from the frame buffer in 160 pixel tiles,
  293.           if the input window is not aligned to these blocks, more pixels may
  294.           need to be fetched that are actually used in the output.  The
  295.           default is TTTTIIIILLLLEEEExxxxPPPPIIIIXXXXEEEELLLL.
  296.  
  297.           ppppeeeeddddeeeessssttttaaaallll==== [OOOOFFFFFFFF|OOOONNNN] - Enables pedestal (also known as setup), an
  298.           artificial black level voltage, for this output.  By default, setup
  299.           is disabled.
  300.  
  301.           ppppiiiixxxxeeeellllffffoooorrrrmmmmaaaatttt====[ RRRRGGGGBBBB11110000 | RRRRGGGGBBBBAAAA11110000 | RRRRGGGGBBBB11112222 | ZZZZ | FFFFSSSS ] - Specifies the
  302.           output pixel format for this channel.  You may specify RRRRGGGGBBBB11110000 to
  303.           indicate 10-bit RGB (no alpha), RRRRGGGGBBBBAAAA11110000 to indicate 10-bit RGB (with
  304.           alpha), RRRRGGGGBBBB11112222 to indicate 12-bit RGB (no alpha), ZZZZ to indicate 24-
  305.           bit Z component, or FFFFSSSS to indicate stereo field sequential.  The
  306.           output pixel format is unrelated to the underlying frame buffer
  307.           organization.  The default is RRRRGGGGBBBB11110000.
  308.  
  309.  
  310.           ssssccccaaaannnn====[ PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE | IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD | SSSSTTTTAAAACCCCKKKKEEEEDDDD ] - Specifies the field
  311.           layout of this channel in the frame buffer.  PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE specifies
  312.           sequential data fetching, in which each field draws from the entire
  313.           source region of the channel.  This is the default.  IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD
  314.           specifies an interlaced output format, in which the lines of the
  315.           fields are vertically interleaved in the frame buffer.  SSSSTTTTAAAACCCCKKKKEEEEDDDD
  316.           specifies an interlaced output format, in which the lines of each
  317.           field are contiguous; the lines of the first of _n fields occupy the
  318.           top _nth of the frame buffer, the lines of the second field occupy
  319.           the next _nth, and so on.  The default is either PPPPRRRROOOOGGGGRRRREEEESSSSSSSSIIIIVVVVEEEE or
  320.           IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD, according to the channel's video format.  SSSSTTTTAAAACCCCKKKKEEEEDDDD field
  321.           layout allows you to reduce fill, rendering only the visible lines
  322.           of each field of an interlaced format.
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  335.  
  336.  
  337.  
  338.           sssscccchhhhpppphhhhaaaasssseeee====<_p_h_a_s_e> - Specifies the subcarrier-to-H phase of the output
  339.           of the channel.  Note this value is useful only on the encoder
  340.           channel.
  341.  
  342.           ssssoooouuuurrrrcccceeeecccchhhhaaaannnnnnnneeeellll====<_c_h_a_n_n_e_l _n_u_m_b_e_r> - Specifies the channel on which the
  343.           current channel is dependent.  If the source channel is the same as
  344.           the current channel, the channel will run in independent mode.  In
  345.           dependent mode, a portion of the visible surface from the source
  346.           channel is sent to this channel for video out.  Only the encoder,
  347.           Sirius, and GVO  channels can operate in dependent mode.  By
  348.           default, this is the same as the channel number.
  349.  
  350.           ssssoooouuuurrrrcccceeeelllloooocccc====_w++++_h - Specifies the default origin of the source rectangle
  351.           of this channel in the frame buffer.  The location is specified in
  352.           pixels, and is relative to the upper-left corner of the screen.  The
  353.           default origin is 0000++++0000.
  354.  
  355.           ssssoooouuuurrrrcccceeeessssiiiizzzzeeee====_Xxxxx_Y - Specifies the default size in pixels of the source
  356.           rectangle of this channel in the frame buffer.  This rectangle may
  357.           be larger or smaller than the video format, but must be within the
  358.           bounds specified by mmmmiiiinnnnssssiiiizzzzeeee and mmmmaaaaxxxxssssiiiizzzzeeee.  This parameter is used for
  359.           resizing pixels from the frame buffer for display.  Setting it
  360.           smaller or larger than the output size of the video format will
  361.           cause the pixels to be magnified or minified.  The default size is
  362.           that of the video format for this channel.
  363.  
  364.           ssssyyyynnnncccc==== [RRRR | GGGG | BBBB] - Specifies which of the output components have
  365.           sync enabled.  Use a single letter or a combination of RRRR (red
  366.           component), GGGG (green component), and BBBB (blue component).
  367.  
  368.           ssssyyyynnnnccccppppoooorrrrtttt==== [CCCC|HHHH] - Specifies the default setting for the output of
  369.           the alternate sync port.  Specifying CCCC places composite sync on the
  370.           sync port.  Specifying HHHH places horizontal sync on the sync port.
  371.           The default is CCCC.
  372.  
  373.           ssssyyyynnnnccccttttrrrriiiilllleeeevvvveeeellll==== [OOOONNNN|OOOOFFFFFFFF] - Enables tri-level sync on the RGB outputs.
  374.           The default is OOOOFFFFFFFF.
  375.  
  376.           uuuusssseeeeggggaaaammmmmmmmaaaa==== [OOOONNNN|OOOOFFFFFFFF] - Specifies whether the gamma values specified
  377.           for this channel should be used in generating the output video.  If
  378.           uuuusssseeeeggggaaaammmmmmmmaaaa is OOOOFFFFFFFF, the default gamma value will be used instead.  The
  379.           gggglllloooobbbbaaaallllggggaaaammmmmmmmaaaa global parameter overrides this option.
  380.  
  381.           vvvvpppphhhhaaaasssseeee====<_v_a_l_u_e> - Specifies the default vertical phase value for this
  382.           channel.  This setting applies only if the channel is genlocked to
  383.           external sync.  vvvvpppphhhhaaaasssseeee ranges from 0 to the number of lines in the
  384.           video format minus one.  The default value is 0.
  385.  
  386.      Other options available with ircombine:
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  401.  
  402.  
  403.  
  404.      ----ddddeeeessssccccrrrriiiippppttttiiiioooonnnn<_d_e_s_c_r_i_p_t_i_o_n> Specifies a string of up to 256 characters
  405.      which describes the combination.  If <_d_e_s_c_r_i_p_t_i_o_n> contains any spaces,
  406.      it should be enclosed in quotes.  If the combination is written to a
  407.      file, this string is included in the file; otherwise it has no effect.
  408.  
  409.  
  410.      ----iiiinnnnppppuuuuttttffffiiiilllleeee<_f_i_l_e_n_a_m_e> - After command line options are exhausted, read
  411.      additional input from _f_i_l_e_n_a_m_e.  This file utilizes the same syntax as
  412.      the command line, except that it may contain carriage returns between
  413.      options or parameters.
  414.  
  415.  
  416.      ----pppprrrriiiinnnnttttccccoooommmmmmmmaaaannnndddd - Generates a command line which would create the ssssoooouuuurrrrcccceeee
  417.      combination.  This command line is printed to stdout.  If the ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnn
  418.      option is specified, it will be reproduced on the generated command line.
  419.  
  420.      ----ttttaaaarrrrggggeeeetttt<_d_i_s_p_l_a_y_n_a_m_e> - Specifies that the graphics system whose video
  421.      format combination will be changed is a display other that specified by
  422.      the DISPLAY environment variable.  This option uses the same format as
  423.      the -display toolkit option.  Note that the -display option does not
  424.      change the target display.  The -target option may also be used to
  425.      specify the pipe for which the combination is to be changed on systems
  426.      with multiple graphics pipes.  If the pipe number is not specified with
  427.      this command line option, the pipe number is extracted from the DISPLAY
  428.      environment variable.
  429.  
  430.      ----vvvvaaaalllliiiiddddaaaatttteeee[_p_a_r_a_m_e_t_e_r=_v_a_l_u_e,...]  - Specifies the hardware configuration
  431.      for which to validate that the video format combination can be supported.
  432.      Any parameter which is not specified by this option defaults to the
  433.      configuration of the target display, if it has _I_n_f_i_n_i_t_e_R_e_a_l_i_t_y graphics.
  434.      Otherwise, the defaults given below are used.  The following parameters
  435.      may be specified with this option:
  436.  
  437.  
  438.           nnnnuuuummmmrrrrmmmmssss====<_c_o_u_n_t> - Specifies the number of raster managers available.
  439.           The default is 1111.
  440.  
  441.           ggggffffxxxxrrrreeeevvvv====<_r_e_v_i_s_i_o_n> - Specifies the version of graphics hardware.
  442.           Valid types are OOOONNNNYYYYXXXX____IIIIRRRR ,,,, OOOONNNNYYYYXXXX2222____IIIIRRRR ,,,, and OOOONNNNYYYYXXXX2222____RRRR.  The default is
  443.           OOOONNNNYYYYXXXX____IIIIRRRR.
  444.  
  445.           nnnnuuuummmmcccchhhhaaaannnnnnnneeeellllssss====<_c_o_u_n_t> - Specifies the number of video channels
  446.           available.  The default is 2222.
  447.  
  448.           cccchhhhaaaannnnnnnneeeellllrrrreeeevvvv====<_r_e_v_i_s_i_o_n> - Specifies the revision number of the video
  449.           channels.  The default is 0000.
  450.  
  451.           ooooppppttttcccchhhhaaaannnnnnnneeeellllttttyyyyppppeeee====<_t_y_p_e> - Specifies the type of the option channel.
  452.           Valid types are NNNNOOOONNNNEEEE ,,,, SSSSIIIIRRRRIIIIUUUUSSSS, GGGGVVVVOOOO, DDDDPPPPLLLLEEEEXXXX, and DDDDVVVVPPPP.  The default is
  453.           NNNNOOOONNNNEEEE.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  467.  
  468.  
  469.  
  470.      ----vvvveeeerrrrbbbboooosssseeee - Enables verbose mode.  This causes a listing of the entire
  471.      video format combination to be printed to stdout.
  472.  
  473.  
  474. SSSSTTTTAAAATTTTUUUUSSSS
  475.      On completion, ircombine returns a 0 if the combination was successfully
  476.      created.  If ircombine was unsuccessful, it returns a non-zero value.
  477.  
  478.  
  479. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  480.      ircombine -destination file 1280x1024_60.cmb \
  481.           -channel 0 format=1280x1024_60.vfo
  482.  
  483.  
  484.           Creates a combination file _1_2_8_0_x_1_0_2_4__6_0._c_m_b with a single channel
  485.           whose format is 1280x1024_60.
  486.  
  487.  
  488.      ircombine -destination active \
  489.           -source file 1280x1024_60.cmb \
  490.           -channel 0 gain = 2
  491.  
  492.  
  493.           Loads the combination stored in _1_2_8_0_x_1_0_2_4__6_0._c_m_b as the current
  494.           combination, and changes channel 0's gain to 2.
  495.  
  496.  
  497.      ircombine -destination file 640x486_30i.cmb \
  498.           -global size=640x486 \
  499.           -channel 0 format=640x486_30i.cmb, scan=INTERLEAVED
  500.  
  501.  
  502.           Creates a combination file _6_4_0_x_4_8_6__3_0_i._c_m_b with a managed area of
  503.           640x486 pixels, a single channel with a 30Hz interleaved format,
  504.           640x486_30i, and whose field layout is IIIINNNNTTTTEEEERRRRLLLLEEEEAAAAVVVVEEEEDDDD.
  505.  
  506.  
  507.      ircombine -destination eeprom \
  508.           -global size=640x480 \
  509.           -channel 0 format=640x480_120s.vfo
  510.  
  511.  
  512.           Stores a combination in the eeprom with a managed area of 640x480
  513.           pixels, and a single channel with a 120Hz stereo format,
  514.           640x480_120s.
  515.  
  516.  
  517.      ircombine -destination file 2@1280x1024_72.cmb \
  518.           -channel 0 format=1280x1024_72.vfo, sourceloc=0+0,
  519.           panstep=LOCKEDxLOCKED \
  520.           -channel 1 format=1280x1024_72.vfo, sourceloc=1280+0,
  521.           panstep=LOCKEDxLOCKED
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))                                                    iiiirrrrccccoooommmmbbbbiiiinnnneeee((((1111GGGG))))
  533.  
  534.  
  535.  
  536.           Creates a combination file _2@_1_2_8_0_x_1_0_2_4__7_2._c_m_b with two channels
  537.           whose formats are both 80x1024_72, and whose source regions are
  538.           located side by side in the frame buffer, with their locations
  539.           fixed.
  540.  
  541.  
  542. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  543.      setmon(1G), Xvc(3).
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.